home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / twhelp60.zip / README.TXT < prev    next >
Text File  |  1993-06-06  |  19KB  |  369 lines
  1.                              Trade Wars Helper 
  2.                                 Release 6.0 
  3.  
  4.                             Copyright 1992,1993 
  5.                              Just FUN Software 
  6.                             All Rights Reserved 
  7.  
  8.  
  9.   Trade Wars Helper is a terminal program used ONLINE with the BBS door
  10.   game "Trade Wars 2002" v1.03 published by Mertech Software.  This
  11.   program continuously maintains a database of the explored sectors with
  12.   their port, adjacent sectors, and other information.  Several commands
  13.   are available to utilize this data while moving around the Trade Wars
  14.   universe including the ability to graphically map a sector and its warps
  15.   to any level!  In addition there are many commands that automate the
  16.   repetitive processes such as negotiating trades on your behalf and
  17.   automatically cross trade between two sectors.  Using this program will
  18.   significantly enhance both your effectiveness and your enjoyment of
  19.   Trade Wars.  Don't leave FedSpace without it! 
  20.  
  21.  
  22.  
  23.   INSTALLATION INSTRUCTIONS 
  24.  
  25.   Make a directory, \twhelp, on your hard disk using the DOS mkdir
  26.   command.  Unzip the ZIP file to the \twhelp directory. 
  27.  
  28.   Erase the TWHELP.CFG file if it is present.  The program will create a
  29.   new configuration file for use with data related to your installation. 
  30.  
  31.   Create a batch file (TWH.BAT) in the directory of your communications
  32.   program like below.  It changes to the \twhelp directory, executes the
  33.   twhelp program, then changes back to your communication program's
  34.   directory. 
  35.  
  36.   cd \twhelp 
  37.   twhelp 
  38.   cd \(comm-prog-dir) 
  39.  
  40.  
  41.  
  42.   RUNNING INSTRUCTIONS 
  43.  
  44.   Run your communications program, login to a BBS and start the Trade Wars
  45.   door.  When Trade Wars begins building its title screen, shell to DOS
  46.   from your communications program and enter TWH to start the batch
  47.   program.  Resolving an insufficient memory condition is discussed below. 
  48.  
  49.   The program will begin with some configuration questions and then ask
  50.   for the file name(s) to use.  There is one database file for each BBS
  51.   game you play.  Once the configuration portion is completed, you begin
  52.   with the main program.  The configuration portion is not repeated on
  53.   subsequent runs although you are given a means to change the options.
  54.  
  55.   Command and instructions are displayed online by the program from this
  56.   point on and will not be repeated here except to say you can display
  57.   them by entering /?, print them by entering /> or output them to the
  58.   text file TWHELP.DOC by entering /<.  All TWH command begin with the /
  59.   character.  COMMANDS ARE CASE SENSITIVE, that is, /b is different from
  60.   /B.  Also be sure to read the text highlighted in white. 
  61.  
  62.   You can use Trade Wars Helper with an existing game or a new game.  For
  63.   an existing game use the /k command to initialize the database for
  64.   sectors you have previously explored.  You generally only use this
  65.   command once per BBS game.  The /K command can be used later to ensure
  66.   the database is up to date in the event of a hardware failure.  It will
  67.   not reissue TW commands to acquire warp to and port information for
  68.   those sectors already in the database. 
  69.  
  70.   You can run the program directly without being connected to a BBS and
  71.   the Trade Wars door.  This might be useful the first time to enter the
  72.   configuration options and read or print the online commands and
  73.   instructions. 
  74.  
  75.   In addition, the file EXAMPLE.TWH contains a database that can be used
  76.   to experiment with the program without being online.  You will need to
  77.   include the sector number after the / for most commands since the
  78.   current sector remains at 1 when not online.  Also do not use the /e,
  79.   /k, /t and most of the advanced commands when not online since they
  80.   issue commands to Trade Wars itself.
  81.  
  82.   For commands like /e, /k, /t and most of the advanced commands Trade
  83.   Wars Helper wait for specific text sequences from Trade Wars before
  84.   proceeding.  It is inevitable that from time to time something will get
  85.   Trade Wars and Trade Wars Helper out of synchronization.  This will
  86.   become apparent when TW Helper goes into an indefinite wait (i.e nothing
  87.   is happening and you can not enter a command).  Simply press the ESC and
  88.   Enter keys until something, such as Trade Wars main command prompt, is
  89.   displayed to get the two programs back in synch. 
  90.  
  91.   You can start the program and specify the database number (1-30) on the
  92.   command line.  For example a batch file line might be TWHELP 21 which
  93.   would start Trade Wars Helper using BBS data file 21.  The title screen
  94.   is not displayed in this case.
  95.  
  96.  
  97.  
  98.   INSUFFICIENT MEMORY 
  99.  
  100.   Trade Wars Helper requires a minimum of 300K to operate and some
  101.   communication programs require around 300K which put you up against the
  102.   DOS 640K barrier.  The following discuses some of the thing you can do
  103.   to resolve this situation. 
  104.  
  105.   First make as much conventional memory available as possible.  This
  106.   means moving drivers, etc. to high memory.  DOS 6.0 MEMMAKER program
  107.   does a good job of this. 
  108.  
  109.   Check you comm program for an option to maximize the DOS shell memory.
  110.   Telemate has this useful capability. 
  111.  
  112.   Lower one or both of the configurations options that affect memory - the
  113.   scroll back buffer size and the communications buffer size.  If the
  114.   communications buffer is too small it will generally show up when using
  115.   a command that accesses the CIM.  A message will be displayed informing
  116.   you to increase the size of the communications buffer. 
  117.  
  118.   Another alternative is to not shell to DOS but, instead, after opening
  119.   the TW door, quit your comm program and then start TWHELP (assumes you
  120.   can quit your comm program without dropping carrier).  Of course after
  121.   quitting TW you will need to restart your comm program.  Some comm
  122.   programs seem to reset the ports baud rate when you quit them.  You will
  123.   recognize this when, after starting TWH, it is unable to communicate
  124.   with the BBS. In this case you will first have to change the
  125.   configuration option to enter the baud rate for each BBS. After changing
  126.   the option, reenter the bbs data filenames and then enter their baud
  127.   rates.
  128.  
  129.   Still another alternative is to use another comm program.  Telemate has
  130.   an option that allows a maximum DOS shell and you can also quit it
  131.   without dropping carrier or having to enter a baud rate. 
  132.  
  133.   And lastly you can contact me and I will consider creating a smaller
  134.   version, without the graphical mapping feature that may solve the
  135.   problem. 
  136.  
  137.  
  138.   UPGRADE INSTRUCTIONS 
  139.  
  140.   If you are upgrading from an older release you can just unzip (or copy)
  141.   all the files from the new release directly into the /twhelp directory.
  142.   You may wish to eliminate the EXAMPLE.TWH file afterward.  You will not
  143.   need to do anything else.  It is not necessary to do the /k command
  144.   again since any changes to the data files will be automatically handled
  145.   by the program.  You may wish to review the Configuration Options as new
  146.   options may have been added. 
  147.  
  148.   Once you have run the new version you can not go back to an older
  149.   version.  This is because the configuration and bbs data files will
  150.   frequently contain additional information that the older version will
  151.   not be aware of. 
  152.  
  153.  
  154.  
  155.   SHAREWARE DISTRIBUTED PRODUCT 
  156.  
  157.   Shareware distribution gives users a chance to try software before
  158.   buying it.  A product distributed via shareware is not "free software".
  159.   If you try a shareware program and continue using it, you are expected
  160.   to register it with the author for a modest fee within 30 days of your
  161.   initial usage.  You may register this product by mailing cash, check or
  162.   a money order for $12.00 US to: 
  163.  
  164.                  Just FUN Software 
  165.                  4790 Naniloa Dr. 
  166.                  Salt Lake City, UT 84117-5547 
  167.  
  168.   Upon receipt of the registration fee, you will be mailed instructions to
  169.   include your name in the program as the registered user.
  170.  
  171.   You must use the REGISTER.TXT file when registering to avoid delays due
  172.   to lack of appropriate information.  This file may be printed using the
  173.   DOS print command.  For example: 
  174.  
  175.                  print \twhelp\register.txt 
  176.  
  177.  
  178.  
  179.   DISCLAIMER 
  180.  
  181.   Trade Wars Helper is supplied on an "as is" basis.  The author disclaims
  182.   all warranties, expressed or implied, including, without limitation, the
  183.   warranties of merchantability and of fitness for any purpose.  The
  184.   author assumes no liability for damages, direct or consequential, which
  185.   may result for the use of Trade Wars Helper. 
  186.  
  187.  
  188.  
  189.   COPYRIGHT 
  190.  
  191.   Copyright laws apply to both shareware and commercial software, and the
  192.   copyright holder retains all rights, with the following exception.  The
  193.   program, complete with the files discussed below, may be freely copied
  194.   and distributed.  It is in fact encouraged.  If you like this program,
  195.   please tell your fellow players, even those evil traders, about it and
  196.   upload it to several BBSes. 
  197.  
  198.  
  199.  
  200.   FILES 
  201.  
  202.   This product is made up of the following files: 
  203.  
  204.   README.TXT - This file contains the text information you are now
  205.   reading. 
  206.  
  207.   README2.TXT - This file contains additional information.  Please read. 
  208.  
  209.   REGISTER.TXT - This file contains a printable registration form.  Please
  210.   use this form when registering. 
  211.  
  212.   ANNOUNCE.TXT - An announcement of this release suitable for posting to a
  213.   BBS or network.  Feel free to do so. 
  214.  
  215.   FILE_ID.DIZ - A description of this product for PCBoard systems. 
  216.  
  217.   TWHELP.EXE - The main program file. 
  218.  
  219.   TWHSETUP.EXE - The setup program file. 
  220.  
  221.   EXAMPLE.TWH - This file contains an example database that can be used to
  222.   experiment with the program.
  223.  
  224.   This product may be distributed only when all the above files are
  225.   included in the distribution. 
  226.  
  227.  
  228.  
  229.   RELEASE ACTIVITY 
  230.  
  231.   Release 1.0: September 7, 1992 - Initial release. 
  232.  
  233.   Release 1.1: September 11, 1992 - Made the COM port and baud rate user
  234.   options.  Changed some of the edit keys for the /b and /c commands. 
  235.  
  236.   Release 1.2: September 30, 1992 - Eliminated the need to specify the
  237.   baud rate.  Added configuration option to optionally reissue the
  238.   universal announcement. 
  239.  
  240.   Release 2.0: October 12, 1992 - Added the /t, Negotiate Trade, command
  241.   along with the automatic cross trading capability.  Also added the /s,
  242.   Search for notation characters, command. 
  243.  
  244.   Release 2.1: October 20, 1992 - Added the option to specify the baud
  245.   rate for those instances where automatic determination does not work. 
  246.  
  247.   Release 3.0: January 5, 1993 - Added the /X, /I, and /U commands to
  248.   expand the search for the next six sectors.  Fixed the problem that
  249.   occurred when entering more than seven data file names at one time.
  250.   Fixed problem associated with using the /k command at high transfer
  251.   rates.  Allowed for ESC to exit program at title screen. 
  252.  
  253.   Release 3.1: February 8, 1993 - Changed the /k command to use the Crai
  254.   computer's interrogation mode to collect the warp to sector information.
  255.   Changed the search for matching notation characters command to /m (was
  256.   /s).  Added the configuration option to enter the IRQ line number.
  257.   Fixed bug that may have caused the auto trading feature to randomly
  258.   fail. 
  259.  
  260.   Release 3.2: February 12, 1993 - Fixed communications software to work
  261.   with modems and I/O cards using the 16550A UART. 
  262.  
  263.   Release 4.0: March 1, 1993 - Added /r command which interrogates the
  264.   Crai computer to record the product percentage for display with the /x
  265.   command information.  Added the /s command which initiates an automatic
  266.   sell/steal cycle.  Added the /> command which prints the command and
  267.   information screens on the standard print device.  Added the /e command
  268.   which explores the closest unexplored sector.  Added the /Z (formerly
  269.   /E) command which clears the explored status for each sector without
  270.   clearing it's port and warp to information.  Added the /o command which
  271.   allows entry of the run time options (RTO).  Added the bugle calls used
  272.   to alert the completion of lengthy processes. 
  273.  
  274.   Release 5.0: April 5, 1993 - Added the capture file feature and the
  275.   scroll back buffer feature.  Added the /D command which shells to DOS.
  276.   Added the /F command which creates data files for the offline analysis
  277.   program TWVIEW and TWASSIST.  Upgraded the communications software to
  278.   the newest version.  Incorporated the results of the psychic probe
  279.   during trading to optimize the experience points realized for the auto
  280.   /t and /s commands.  Added the /l command which is used (after the /r
  281.   command) to locate enemy forces.  Fixed the problem with printing to a
  282.   laser printer.  Added the /d command to display the destination path
  283.   from the current sector.  Added the ability to cross trade between
  284.   nonadjacent sectors using ships equipped with a TransWarp Drive.
  285.   Expanded the Deployed Fighter Scan produced by Trade Wars to include the
  286.   port type, notation characters, product percentages and optionally, the
  287.   number of hops from the current sector.  Added the /f command to deploy
  288.   a single fighter in the toll mode.  Added the /C command which initiates
  289.   automatic colonization of a planet with ability to utilize a TransWarp
  290.   drive when available.  Added the /B command which initiates the
  291.   automatic buying and conveying of product to a planet.  Allowed for
  292.   cross trading between class 4 (SSB) and class 6 (BSS) ports.  Added a
  293.   Run Time Option to specify whether a ship equipped with a Holographic
  294.   Scanner stops at the sector preceding the unexplored sector when using
  295.   the /e command.  Added the /P command which displays the next six
  296.   sectors with a specified port capability.  Added the /E command which
  297.   launches an E-probe to a randomly chosen unexplored sector.  Allowed for
  298.   specifying the database number on the command line.  Changed the /k
  299.   command to use the CIM for both sector and port information. 
  300.  
  301.   Release 5.5: May 17, 1993 - Added the /& command to display the next
  302.   five sectors for the /x, /u, /p, etc.  commands.  Changed the command to
  303.   create the offline analysis files for TWVIEW and/or TWASSIST to /V and
  304.   added the option to create only the individual .FRT, .SCT or .PRT files.
  305.   Made the TWVIEW .SCT file compatible with TWMAP.  Added deployed
  306.   fighters, identified by the TW G and TWH /F (formerly /f) commands, to
  307.   the /d display.  Added the /f command to display the paths to a
  308.   destination sector from the nearest five sectors containing fighters
  309.   preceded by the numbers of hops to the fighters from the current sector.
  310.   Added a check to the /F command to insure fighters are not deployed in
  311.   FedSpace.  Added the /0E command to mark a sector as inaccessible for
  312.   the /E routines.  Added the /1E command to launch an E-probe to a
  313.   randomly chosen isolated sector.  Added the /2E command to launch an
  314.   E-probe so as to pass thru the most sectors not visited during the
  315.   current session.  Added a configuration option so advanced commands are
  316.   only displayed or printed if desired for new users.  Added the /m
  317.   command to display a menu of all the commands on a single screen.  Added
  318.   the /< command to output the online documentation to the text file
  319.   TWHELP.DOC.  Moved the option to sound the bugle calls to the
  320.   configuration options screen.  Added the /M command to merge another
  321.   traders database.  Made the automated process restore the default ANSI
  322.   color which is useful when the TW ANSI mode is off.  Added the analysis
  323.   of the TW Computer X command display to keep track of avoided sectors
  324.   which now are not shown on the various displays or moved to via the /e
  325.   command.  Allowed for cross trading between a class 8 (BBB) port and any
  326.   other class of port.  Allowed for cross trading between a class 7 (SSS)
  327.   port and any other port buying equipment.  Allowed for cross trading
  328.   between two nonadjacent sectors without using the Transwarp Drive.
  329.   Allowed for triple trading which involves all three products at each
  330.   port to maximize experience points.  Added the /X command which displays
  331.   the five closest sectors for nonadjacent cross trading pairs, transwarp
  332.   trading pairs, triple trading pairs, and other specialized combinations.
  333.   Added the product quantities from the /r command to the /x, /p and other
  334.   command displays.  Added a Run Time Option to turn off the haggling over
  335.   price when trading.  Added the /P command which automates the process of
  336.   buying planetary shields with or without using a TransWarp Drive.  Added
  337.   the /Q command which automates the quashing of mines using mine
  338.   disruptors.  Added the /g command which goes to a specified sector while
  339.   optionally deploying fighters (RTO), trading (RTO) and density scanning
  340.   (RTO) along the way.  Added an RTO to optionally deploy/trade/scan when
  341.   using the /e command and added the /2e command which initiates automatic
  342.   exploration of the TW universe.  Added the automatic determination of
  343.   which sectors are Major Space Lanes which are noted as MSL on some
  344.   displays.  Significantly modified the /w display.  Added the /I command
  345.   to display deeply isolated sectors.  Added a configuration option to
  346.   optionally save the fighter, product percentage, and product quantity
  347.   data in the disk file.  Added prompts to the /k command to ask for the
  348.   class 0 and 9 sectors.  Changed the way the destination sector is
  349.   specified for the /d command.  Based on hearsay regarding the new
  350.   release of Trade Wars made the commands that use the CIM allow for
  351.   missing sectors and added a prompt to allow for upto 3000 sectors. 
  352.  
  353.   Release 5.6: May 19, 1993 - Fixed problem of locking up when entering
  354.   number of sectors in universe. 
  355.  
  356.   Release 6.0: June 5, 1993 - Added the /G command to graphically display
  357.   a sector and its warps to any level.  Separated the configuration
  358.   options portion of TWHELP.EXE to a separate file TWHSETUP.EXE.  Added a
  359.   configuration option to specify the size of the communications buffer.
  360.   Changed the /b and /c edit routine so the enter key can insert a line
  361.   and the del key can remove a line.  Added the /R command to initiate the
  362.   robing credits cycle which included a new RTO to set the rob percentage.
  363.   Fixed a bug in the /I routine.  Fixed a bug in displaying the scroll
  364.   back buffer that did damage to the database and configuration files.
  365.   Added communicating at 38,400 and 57,600 bps capability. 
  366.  
  367.  
  368.   Please continue by reading the README2.TXT file. 
  369.